
@C1@c@b@_ Cut and Paste

     Cut a rectangular region of an image and paste it at different
     location or into another image.

@b Interaction

     Use leftmouse to cut (or C key) and middlemouse (or P key) to
     paste. Uu to undo last paste.

     Click on Done or type Esc in the main window to exit.

@f Cut Size
     To change the size of the cut region, use the following keyboard keys:

@f     xX: Decrease/Increase the cut width
@f     yY: Decrease/Increase the cut height
@f  [1-9]: Step size

     Click rightmouse for comprehensive size change. To finish,  click away
     from the small crosses.

@f Cut buffers
     A cut buffer may be obtained by one of the following methods:
       1. A direct screen read 
       2. Same region but via internal memory 
       3. import an external file.

     Method 1 & 2 can be toggled by the ReadScr/Internal button. When
     ReadScr is active, everything that falls within the cut region
     will be read into the cut buffer, which may be useful in certain
     situations to create special effects. In general, screen reads
     should be avoided on machines with less than 24bitplanes.

     To import an external image, click on the Import button. The imported
     image can be of any bit supported format and behaves exactly the
     same as a normal cut buffer except that it can not be named, thus
     a new cut buffer or import overwrites the current imported image.

     Note in method 2, the cut region is not allowed outside the image.

@f Modes of Operations
     Toggle the Overwrite/Mask button to choose pasting method:

     Overwrite: completely overwrites the region of the image that is 
		being pasted. 

     Masking:   non-zero pixels in the cut buffer replace the corresponding
		pixels in the image while leaving alone the pixels that
		correspond to zero pixels in the cut buffer,
		i.e., newpix = (mask ? mask:oldpix).


     The Preview/Commit button controls if to modify the image when a
     cut buffer is pasted. When Preview is active, pasting will only
     modify the image in the framebuffer (that is, currently on screen),
     but not the image in core. For that to happen, toggle on the
     Commit mode. 

     In Commit mode or Mask mode, the paste region is not allowed outside
     the image for obvious reasons. To paste outside the image, use 
     Preview and then do a crop with CropFill off to render it into the image.

@s@b Note
    1. Mask mode has no effect for colormapped images.
    2. If cut & paste is done across images, the pasted image will be in
       RGB regardless what the original type is.
    3. If importing an image larger than the current one, nothing meaningful
       can be done. Do the reverse.

